Use case: pulse counter

Sequence diagram

Low power timer pulse counter

@startuml title: Low Power Timer Pulse Counter participant "User Application" as appli participant "<font color=green><b>HAL LPTIM</b></font>" as LPTIM group#Bisque #Linen LPTIM Pulse Counter Operation == Initialization and Configuration == appli -> LPTIM: HAL_LPTIM_Init() LPTIM --> appli: <color #008000>HAL_OK == LPTIM counter mode Process == appli -> LPTIM: HAL_LPTIM_Counter_Start_IT() LPTIM --> appli: <color #008000>HAL_OK hnote across: Enter Low Power Mode == Stop LPTIM counter and De-Initialize the LPTIM instance== appli -> LPTIM: HAL_LPTIM_Counter_Stop_IT() LPTIM --> appli: <color #008000>HAL_OK appli -> LPTIM: HAL_LPTIM_DeInit() LPTIM --> appli: <color #008000>HAL_OK end @enduml

Code snippet

HAL1

HAL2 

LPTIM_HandleTypeDef             LptimHandle;



LptimHandle.Instance = LPTIM1;

LptimHandle.Init.Clock.Source      = LPTIM_CLOCKSOURCE_APBCLOCK_LPOSC;
LptimHandle.Init.Clock.Prescaler   = LPTIM_PRESCALER_DIV1;
LptimHandle.Init.CounterSource     = LPTIM_COUNTERSOURCE_EXTERNAL;
LptimHandle.Init.Trigger.Source    = LPTIM_TRIGSOURCE_SOFTWARE;
LptimHandle.Init.UpdateMode        = LPTIM_UPDATE_IMMEDIATE;

LptimHandle.Init.OutputPolarity    = LPTIM_OUTPUTPOLARITY_LOW;
LptimHandle.Init.Input1Source      = LPTIM_INPUT1SOURCE_GPIO;
LptimHandle.Init.Input2Source      = LPTIM_INPUT2SOURCE_GPIO;
LptimHandle.Init.RepetitionCounter = 0;








/* Initialize LPTIM peripheral according to the passed parameters */
HAL_LPTIM_Init(&LptimHandle);




/* Start the process */
HAL_LPTIM_Counter_Start_IT(&LptimHandle, 99);

/* Enter in Stop mode */
HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI);

/* Stop PWM when done and DeInitialize the LPTIM instance */
HAL_LPTIM_Counter_Stop_IT(&LptimHandle);
HAL_LPTIM_DeInit(&LPTIM_Handle);

hal_lptim_handle_t LPTIM_Handle;

hal_lptim_config_t p_config;
hal_lptim_input1_config_t in1Config;
hal_lptim_oc_config_t sConfig;

p_config.clock_source = HAL_LPTIM_CLK_INTERNAL;
p_config.mode = HAL_LPTIM_CONTINUOUS;
p_config.prescaler = HAL_LPTIM_CLK_SRC_DIV1;
p_config.repetition_counter = 0;
p_config.period = 99;

sConfig.polarity = HAL_LPTIM_OC_LOW;

/* Set Input1 config */
in1Config.src = HAL_LPTIM_INPUT1_GPIO;
in1Config.filter = HAL_LPTIM_FDIV1;
in1Config.polarity = HAL_LPTIM_INPUT1_RISING;






/* Initialize and configure the LPTIM Instance */
HAL_LPTIM_Init(&LPTIM_Handle, HAL_LPTIM1);
HAL_LPTIM_SetConfig(&LPTIM_Handle, &p_config);

HAL_LPTIM_SetConfigInput1(&LPTIM_Handle, &in1Config);

/* Start the process */
HAL_LPTIM_Start_IT(&LPTIM_Handle);

/* Enter in Stop mode */
HAL_PWR_EnterStopMode(HAL_PWR_LOW_PWR_MODE_WFE, HAL_PWR_STOP0_MODE);

/*Stop an deinitialize LPTIM instance*/
HAL_LPTIM_Stop_IT(&LPTIM_Handle);
HAL_LPTIM_DeInit(&LPTIM_Handle);

Key changes

  1. HAL2 splits configuration from initialization using HAL_LPTIM_SetConfig().

  2. HAL2 configures the input path explicitly using HAL_LPTIM_SetConfigInput1().

  3. HAL2 uses HAL_LPTIM_Start_IT()/ HAL_LPTIM_Stop_IT() instead of the HAL1 counter start/stop APIs.